home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / COMMUNIC / 2565.ZIP / JCOMM224.ZIP / JCOMM.HLP < prev    next >
Text File  |  1990-06-25  |  9KB  |  344 lines
  1. [main
  2.              J-COMM Help Index.
  3.             --------------------
  4.  
  5.         KEY          TOPIC
  6.  
  7.          1      Configuration.
  8.          2      Dialup Settings.
  9.          3      Modem Command Strings.
  10.          4      Making a Call.
  11.          5      Downloading.
  12.          6      Uploading.
  13.          7      Text Capture.
  14.          8      Script Files.
  15.          9      About J-COMM.
  16.  
  17.         Esc     Exit Help.
  18.  
  19.     Use specified keys, PgUp, PgDn or Esc
  20. ];1:conf;2:param;3:mcmd;4:dial;5:down;6:up;7:cap;8:scr1;9:info;q:conf;
  21. [conf
  22.            Configuring JCOMM
  23.           -------------------
  24.  
  25. J-COMM must be told about the modem  you  are
  26. using.  You must  specify which  serial  port
  27. you are using (if the modem is inside the  PC
  28. it is probably using port 2), whether  it  is
  29. dumb or smart (modern modems are  all  smart)
  30. and whether it can do error correction (cheap
  31. modems usually can't).  Handshaking  is  only
  32. required if you are using a fast modem or are
  33. linked directly to another computer.
  34.  
  35. You may also specify whether you want  J-COMM
  36. to keep a log of connections, and  the  paths
  37. to be used for uploaded and downloaded files,
  38. and for the log.
  39.  
  40. press Esc-menu
  41. ]main;i:main;q:param;
  42. [param
  43.              Dialup Settings
  44.             -----------------
  45.  
  46. In order to communicate with a service J-COMM
  47. must be told the number to  dial,  the  speed
  48. used, the format of the data used and whether
  49. the service uses error correction.
  50.  
  51. Most bulletin boards support 1200 baud, 8-N-1
  52. full duplex, no error correction.  If garbage
  53. appears  consistently,  the   format  may  be
  54. wrong, try 7-E-1.
  55.  
  56. If you cannot see the characters you type try
  57. half duplex; if each key appears  twice,  use
  58. full duplex.
  59.  
  60. press Esc-menu
  61. ]main;i:conf;q:mcmd;
  62. [mcmd
  63.            Modem Command Strings
  64.           -----------------------
  65.  
  66. Modem command strings are  used  to  instruct
  67. smart modems to  dial  a  number,  use  error
  68. correction, hang up the line and so on.
  69.  
  70. Most modems use Hayes commands, and  the  set
  71. provided as a default will work with many  of
  72. the lower cost modems.
  73.  
  74. If it is  necessary  to  change  the  command
  75. strings,  then  there  is  no alternative but
  76. to refer to your  modem's  manual,  as  there
  77. are   many  variations  on  the  basic  Hayes
  78. commands.
  79.  
  80. press Esc-menu
  81. ]main;i:param;q:dial;
  82. [dial
  83.                 Making a Call
  84.                ---------------
  85.  
  86. To call an online service, use  F3  Dial,  and
  87. select the name of the service from the  menu.
  88. You can abort the call by pressing Esc.
  89.  
  90. J-COMM will attempt to make a connection up to
  91. 5 times, as set in the Communications  Params.
  92. Progress is reported on the terminal screen.
  93.  
  94. Once a connection is  made,  the  status  line
  95. will show ONLINE and  the  named  script  file
  96. will be executed.
  97.  
  98. To terminate  the  call,  sign  off  from  the
  99. online service, then press F4 Hangup.
  100.  
  101. press Esc-menu
  102. ]main;i:mcmd;q:down;
  103. [down
  104.                  Downloading
  105.                 -------------
  106.  
  107. To download a file, you must first know  which
  108. transfer protocol the remote computer uses.
  109.  
  110. You will need to give the  remote  computer  a
  111. command to tell  it  what  file  you  wish  to
  112. download.  As soon as the remote computer says
  113. it is ready, press F5 Receive.  Enter  a  name
  114. for the received file to be  written  to,  and
  115. choose the protocol.  The transfer  will  then
  116. begin, a bar graph will show progress.
  117.  
  118. File transfer protocols available  are:  TEXT,
  119. XMODEM, YMODEM and YMODEM-G.
  120.  
  121. press E-errors Esc-menu
  122. ]main;i:dial;q:up;E-err;
  123. [up
  124.                   Uploading
  125.                  -----------
  126.  
  127. To upload a file, you must  first  know  which
  128. transfer protocol the remote computer uses.
  129.  
  130. You will need to tell the remote  computer  to
  131. be ready to receive a file.  As  soon  as  the
  132. remote  computer  says  it  is  ready,   press
  133. F6 Transmit.  Enter a name for the file to  be
  134. sent, and choose the protocol.   The  transfer
  135. will then begin, a bar graph showing progress.
  136.  
  137. File transfer protocols available  are:  TEXT,
  138. XMODEM, YMODEM and YMODEM-G.
  139.  
  140. press E-errors Esc-menu
  141. ]main;i:down;q:err;E-err;
  142. [err
  143.             File Transfer Errors
  144.            ----------------------
  145.  
  146. The following errors are indicated during an
  147. XMODEM or YMODEM file transfer:
  148.  
  149.     T   : Timeout occurred (no reply in 10s).
  150.  
  151.     P   : Previous block was retransmitted.
  152.  
  153.     L   : Block received was too long.
  154.  
  155.     B   : Block number received was invalid.
  156.  
  157.     C   : Checksum/CRC error.
  158.  
  159.     N   : Negative acknowledgement received.
  160.  
  161. press Esc-menu
  162. ]main;i:up;q:cap;
  163. [cap
  164.                  Text Capture
  165.                 --------------
  166.  
  167. A  copy  of  text  received  from  the  remote
  168. computer, as well as commands you type, can be
  169. captured in a file.
  170.  
  171. Text is captured to a file CAPTURED.TXT.  Text
  172. capturing can be turned on and off by pressing
  173. the F7 Capture key.  The  legend  'CAPT'  will
  174. show on  the  status  line,  if  capturing  is
  175. currently turned on.
  176.  
  177. press Esc-menu
  178. ]main;i:up;q:scr1;
  179. [scr1
  180.                  Script Files
  181.                 --------------
  182.  
  183. Script files are simple 'programs'  which  are
  184. used to automate communications tasks such  as
  185. logging on to a remote computer or downloading
  186. a file.
  187.  
  188. A script file can be automatically run:
  189.         - as soon as J-COMM is  loaded  (named
  190.           in the command line);
  191.         - immediately a connection is made.
  192.  
  193. Sequences of script commands, called 'macros',
  194. can be set up and will be executed whenever an
  195. Alt/key combination is pressed.
  196.  
  197. press PgDn-more M-Macros C-Commands Esc-menu
  198. ]main;M:mac;C:sc1;i:cap;q:scr2;
  199. [scr2
  200.              Script Files (cont)
  201.             ---------------------
  202.  
  203. Script files  must  be  written  to  a  strict
  204. format:
  205.  
  206.     :label  command  parameter(s)
  207.  
  208. Labels, if present, must  begin  in  column  1
  209. with  a  colon  (:)  and  may  be  up  to   12
  210. characters long.
  211.  
  212. Commands and  parameters  are  separated  from
  213. each other by one or  more  spaces.   Commands
  214. may be indented for clarity.
  215.  
  216.  
  217.  
  218. press Esc-menu
  219. ]main;i:scr1;q:mac;
  220. [mac
  221.                     Macros
  222.                    --------
  223.  
  224. A macro is part of a script which is  executed
  225. whenever an Alt/key combination is pressed.  A
  226. macro is defined in the script by:
  227.  
  228.         ALT <letter> IS <label>
  229.  
  230. and the macro commands would be:
  231.  
  232.         :<label>
  233.             command 1
  234.             command 2
  235.               .....
  236.             Exit
  237.  
  238. press Esc-script menu
  239. ]scr1;i:scr2;q:sc1;
  240. [sc1
  241.                 Script Commands
  242.                -----------------
  243. ALT     : ALT <key> IS <label>
  244.           defines a macro.
  245. CALL    : CALL <label>
  246.           execute a subroutine.
  247. CAPTURE : CAPTURE <ON|OFF>
  248.           toggle text capture on/off.
  249. DIAL    : DIAL <name>
  250.           dial the named service.
  251. EXIT    : EXIT
  252.           exit script, subroutine or macro.
  253. IF      : IF [NOT] <condition>
  254.              .. command(s) ..
  255.           ELSE
  256.              .. command(s) ..
  257.           END
  258.           execute commands conditionally
  259. press PgDn-more Esc-script menu
  260. ]scr1;i:mac;q:sc2;
  261. [sc2
  262.              Script Commands (cont)
  263.             ------------------------
  264.  
  265. MESSAGE : MESSAGE <text>
  266.           display a message to the user.
  267. NOTE    : NOTE <text>
  268.           explanatory comment in script.
  269. PAUSE   : PAUSE <n>
  270.           pause script for n seconds.
  271. QUIT    : QUIT
  272.           terminate script and exit J-COMM.
  273. RECEIVE : RECEIVE <protocol> <filename>
  274.           download file using protocol.
  275. REPEAT  : REPEAT
  276.             .. command(s) ..
  277.           UNTIL [NOT] <condition>
  278.           loop until condition is met.
  279.  
  280. press PgDn-more Esc-script menu
  281. ]scr1;i:sc1;q:sc3;
  282. [sc3
  283.              Script Commands (cont)
  284.             ------------------------
  285.  
  286. SEND    : SEND <text>
  287.           send text string (^M = Enter).
  288.           SEND ?<prompt>
  289.           prompt user for text and send it.
  290. TRACE   : TRACE <ON|OFF>
  291.           toggle script tracing on/off.
  292. TRANSMIT: TRANSMIT <protocol> <filename>
  293.           upload file using protocol.
  294. WAITFOR : WAITFOR <text>
  295.           wait up to w seconds for text to be
  296.           received.
  297. WAITTIME: WAITTIME <w>
  298.           set 'waitfor' time to w seconds.
  299.  
  300.  
  301. press PgDn-more Esc-script menu
  302. ]scr1;i:sc2;q:sc4;
  303. [sc4
  304.                   Conditions
  305.                  ------------
  306.  
  307. MNP     : TRUE if error correction operating.
  308.  
  309. OK      : TRUE if previous file transfer or
  310.           WAITFOR command was successful.
  311.  
  312. ONLINE  : TRUE if modem is online.
  313.  
  314. RECEIVED <text>
  315.         : TRUE if <text> was received during
  316.           last PAUSE or WAITFOR command.
  317.  
  318. TIME <hh:mm>
  319.         : TRUE if time is as specified.
  320.  
  321.  
  322. press Esc-script menu
  323. ]scr1;i:sc3;q:info;
  324. [info
  325.                  About J-COMM
  326.                 --------------
  327.  
  328. J-COMM was written by Julian V Moss.  Version
  329. 1 first appeared in October 1988.  The latest
  330. version has been developed using the TopSpeed
  331. integrated development environment,  using  a
  332. combination of Modula-2, C and assembler.
  333.  
  334. Comments, bug  reports  and  suggestions  are
  335. welcome to:
  336.                J M Associates
  337.          21 Godmans Lane, Marks Tey
  338.      Colchester, CO6 1LU, United Kingdom
  339.  
  340.             email: jmoss@cix.uucp
  341.  
  342. MNP is a registered trademark of Microcom Inc.
  343.  
  344. ]main;i:sc4;